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Section 1 
INTRODUCTION 

The AFAS Database System was developed to provide the basic structure of a 
comprehensive database system for the MSFC Structures and Dynamics Laboratory 
Aerophysics Division. The system is intended to handle all of the Aerophysics Division 
Test Facilities as well as data from other sources. The system has been written for 
the DEC VAX family of computers in FORTRAN -77 and utilizes the VMS indexed file 
system and screen management routines. 

The database system recognizes three levels of interface to the system: the Data- 
base Manager who has overall system control, the Test Engineer who is responsible 
for the entry and validation of the data, and the User who accesses the data. Two 
types of test data are maintained: measured data with filenames using an "M" suffix, 
and engineering data with file names using an "E" suffix. The measured files contain 
test data. The engineering files contain data that have been reduced or manipulated 
by the Test Engineer. 

The database directory structure has a root level directory with subdirectories repre- 
senting each data source (facility). Each source directory contains subdirectories corre- 
sponding to specific tests. The directory tree structure is illustrated below. 


DBDISK: [DBSE] 



At the highest directory level the system provides an index file to all tests available 
on the system. The directory for each test may contain a number of informational files. 
The four basic files involved in the stored data structure are: the VALUE file, LABEL file, 
the SET file, and the CHANGE LOG file. 

The VALUE file stores test data as a matrix which can be visualized as columns 
representing measurements (or test parameters) and rows representing test conditions. 
The data values are stored in an indexed file using the data label describing the 
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measurement as the record key. The desired test condition is located by an offset 
in each record. 

The LABEL file contains a record for each data label. Information in the record 
defines characteristics of the measured data values corresponding to the label. The 
purpose of this record is to provide the system and the user with information about the 
measurement. The structure of the label file record is defined by a PARAMETER file. 
This allows the Database Manager to specify field names and field lengths to be used 
for measurement description on a particular test. There are five required fields in the 
PARAMETER file : the key field ENGR_LABEL, which is an all uppercase representation 
of the data label; CASE_LABEL, which is the character representation of the label as the 
user will see it; DATATYPE which determines the data type of the label data; FLDLEN, 
which determines the data field length; DATA_SEGMENT used to tag the data retrieval 
path. Other optional fields might include: a short descriptor for the measurement, units 
for the measurement, or geometry values locating the measurement. 

The SET file contains groupings of data labels which are desired for applications 
such as plotting of geometrically related data and sequencing of input data. This is an 
indexed file using the set name as the key. The set name is followed in the record by 
the X, Y, and Z parameter names. The balance of the record consists of fields of data 
label names and their associated X, Y, and Z parameter values. 

The CHANGE LOG contains a history of modifications made to the VALUE file data. 
This is an indexed file using the data label as the key. A log entry consists of a data 
label and offset to determine the cell position, the original cell value, the number of 
modifications made, and, for each modification: the new value, the user name of process 
that modified the data, the date the cell was modified, and the time the cell was modified. 
The CHANGE LOG is used to track modifications made to the VALUE file and to retrieve 
previous values. 

The balance of this document contains: a description of the user interface, lists of all 
code structure elements, descriptions of the file structures, a description of the security 
system operation, a detailed description of the data retrieval tasks, a description of the 
session log, and a description of the archival system. 
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Section 2 
USER INTERFACE 

The AFAS Database System uses a menu-driven interface to a network of data files 
and information files that can provide data on any test in the database. Database access 
is organized into three levels: Database Manager, Test Engineer, and User. The tasks 
associated with each level are summarized in Table 2.1. 

When a user accesses the database system a top level menu (Table 2.2) lists the 
options for which the user is privileged. The User level functions are available to all 
users, but the database manager functions are not available to the Test Engineer or 
User access levels. Each of the options presented in the top level menu represent a 
separate executable file. There are a number of key functions that are common to all 
menus and may not be listed on the display due to space restrictions. Table 2.3 lists 
the universal key functions. 

The user may obtain on-line help by entering "?" at any point where the system is 
requesting input. The information pertaining to the current option will be displayed on 
the screen. While viewing the on-line help, the user may obtain help information from 
subsequent option levels by typing the desired level option. A list of additional help 
items, if available, is displayed at the bottom of the help screen. The user exits the 
help facility by entering CNTRL/K. A CNTRL/K is entered by striking the "Ctrl" and "K" 
keys simultaneously. 
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Table 2.1: Database System Main Menu 


To gain access to the database system enter "DBS.” This will display the database 
options menu. The menu options vary according to the privilege assigned to the user 
gaining access. The complete menu contains the following options. 


0 « » 

M — 

Management Services 

E — 

Test Engineer Tasks 

A — 

Archival Tasks 

R — 

Test Data Load/Retrieval 

T — 

View Data Table 

V — 

View Reports 

Select — 

Select/Browse Available Tests 

Q — 

Quit 


Option Description 

M Executes the Database Manager Tasks. 

E Executes the Test Engineer Tasks. 

A Executes the Data Archival Tasks. 

R Executes the Data Retrieval Tasks which enable a user to create RS/1 
compatible data files from the test data in the database. 

T Allows the user to view the VALUE file for the currently selected test. 

V Allows the user to view the available reports for the currently selected test. 

Select Allows the user to view a list of tests available on the system and to select 

one of these tests as the current test. 

Q Exits the AFAS Database System and returns control to the DCL environ- 
ment. 
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Table 2.2: Database Function Summary 


Database Manager Functions 

• Maintain the database index file describing all tests in the system. 

• Create parameter files which specify fields to be used in describing Labels. 

• Create and load the "engineering" files. 

• Remove invalid data from value files. 

• Control archival of test data. 

• Maintain database system security. 

• Install text files for reports. 

Test Engineer Functions 

• Create and maintain the Label file of unique labels with descriptive information. 

• Create and maintain the Set file to be used for associating plotting groups and 
specifying input formats. 

• Mark invalid data in the value file. 

• Rebuild the value file as necessary to maintain proper organization. 

• Enter measured data into the value file. 

• Prepare engineering data in RS/1 Tables which the Database Manager can load into 
the engineering value file. 

User Level Functions 

• Begin a new session or continue a previous data retrieval session by specifying the 
previous session name. 

• View all data or a data summary to determine the data of interest. 

• Select data by entering data labels and/or sets, or select the labels and sets from 
scrolled lists. The user may restrict the data retrieved for a label by entering ranges 
or requesting that data cells that do not have valid data be removed. 

• Select output. The user has the option of creating a printed report of the data 
selected, loading the data into BBN RS/1 tables, creating meta-files, or storing the 
retrieval session in a session log. 
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Table 2.3: Universal Key Functions 


Key Sequence 
CNTRL/K 
CNTRL/E 
"PF4" 

Left Arrow 
Right Arrow 


Result 

Exit current menu. 

Exit program. 

Erase input field from cursor to end of field. 
Move left in input field. 

Move right in input field 

Display help for current item or screen. 


Notes: CNTRUE may not be implemented at points where a valid input is necessary 

Help may not be available where spawned tasks do not allow for trapping the 
"?” character. 
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Section 3 

CODE STRUCTURE 

The Database System is comprised of eight executable code sections. The 
source code for each section resides in a subdirectory of the directory DB- 
DISK:[DBSE. SOURCE]. All routines common to two or more code sections reside in 
the library directory DBDISK:[DBSE. SOURCE. LIBRARY]. Table 3.1 lists the code sec- 
tions and briefly describes each. A complete listing of all routines in the database system 
is provided in Appendix A. A listing of the arguments passed to each routine is provided 
in Appendix B. 

A "make" facility has been provided to build the executable files when changes have 
been made to the source code. A make file has been provided for each executable file. 
The make files reside in the source directories and are named <executable_file>.MAK, 
where <executable_file> is the name of the executable. The files <executable_file>.COM 
and <executable_file>.OPT may also be present in the directory and are part of the 
make facility. The .COM file contains the link command. The .OPT file will be present 
whenever the link command in the .COM file exceeds the buffer capacity of the command 
interpreter (256 characters). The .OPT file will then be used to name the additional 
modules. After a source file has been modified, the executable is updated by typing 
"FMAKE <executable_name>". This will process the make file <executable_file>.MAK. 
Table 3.2 lists the symbol definitions required for database system maintenance. A brief 
description of the .MAK, .COM, and .OPT files follows. 

<executable_file>. M AK 

This file contains the commands for the make facility. The make facility looks at the 
target file date and checks the dependent file dates to see if any of the dependent files 
have later dates. If a dependent file date is more recent than the target file the next 
DCL command in the .MAK file is executed. If the date of the target file is the more 
recent the next DCL command in the .MAK file is skipped. The target files in the .MAK 
files are designated by the line "$!=<file_name>". The dependent files are designated 
by "$!><file_name>". The following is an example .MAK file that compiles and links the 
file TEST. FOR. 

$!=TEST.OBJ 
$!>TEST.FOR 
$!>TEST.INC 
$ FOR TEST 
$! 

$! Comment line 
$! 

$!=TEST.EXE 
$!>TEST.OBJ 
$ LINK TEST 
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<executable_file>.COM 

This file contains the link command to build the executable file. This file is executed 
from within the .MAK file 

<executable_file>.OPT 

This file contains the link options for the link command. This file is specified in the 
.COM file. An options file will be present whenever the link command exceeded the 
buffer capacity of the command interpreter (256 characters). 
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Table 3.1: Database Code Sections 


Code Section 

Directory 

Description 

DBS_MGR 

[,..DBS_MGR 

Database Manager source and executable. 

DBS_DAT 

[...DBS_DAT] 

Test Engineer source and executable. 

ARCHIVE 

[...ARCHIVE] 

Archival system source and executable. 

USER 

[...USER] 

User source and executable. 

DB_EDIT 

[...DB_EDIT] 

Tabled data display source and executable. 

REPORTS 

[...REPORTS] 

Report viewer source and executable. 

BROWSER 

[...BROWSER] 

Available tests browser source and executable. 

DBS_LBR 

[...DBS_LBR] 

Source files for library routines. 

MAIN_MENU 

[...MAIN_MENU] 

Main menu source and executable. 

NOTE: [...<directory>] indicates that the directory resides under the parent directory 

DBDISK:[DBSE.SOURCE]. 
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Table 3.2: Symbols and Logicals Used by Database 


The AFAS Database System uses several logical and symbol definitions to locate 
the necessary files. DBDISK and DBS are required by all users. The remaining symbols 
and logicals are required for maintaining the code. 

DBS == "@DBDISK:[DBSE.SOURCE.MAIN_MENU]MAIN_MENU" 

FMAKE == "$DBDISK:[DBSE.SOURCE.MAKE]FMAKE" 

DEFINE DBDISK <disk containing source code> 

DEFINE INCLUDES DBDISK:[DBSE.SOURCE.INCLUDES] 

DEFINE DBS_LBR DBDISK:[DBSE.SOURCE.DBS_LBR] 

DBS_EDITOR == <session log editor> 

DBS starts the AFAS Database System. 

FMAKE executes the make facility. 

DBDISK is the AFAS Database System "home" disk. 

INCLUDES determines the location of the required include files. 

DBS_LBR determines the location of the common subroutines and function. 

DBS_EDITOR is a user-defined symbol that should point to the user’s editor of prefer- 
ence. The editor should provide full-screen editing capability. 
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Section 4 

FILE STRUCTURES 

The AFAS Database System uses several file types to store test data and related 
information. Table 4.1 provides a list of the files and a brief description of their function. 
Appendix C describes each file, its record structure, and lists the FDL file and the 
structure description file, if one is available. 
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Table 4.1: System Files 


Nomenclature: SOURCE 

— Facility or other data source, i.e., TWT. 

TEST 

— Test identifier, i.e., 0023. 



— File type suffix: M — measured data 



E — engineering data 

<file> 

— Denotes user specified path and name. 

<session> 

— Denotes user-specified session name. 

File Name and Path in 
DBDISK:[DBSE] 

V : Description 


System Files 

ARCHIVE.HLP 

DBS_DAT.HLP 

DBS_MGR.HLP 

DB_EDIT.HLP 

DATA_RETRIEVAL.HLP 

ARCH_MASTER.FDL 

CHANGE_LOG.FDL 

SET.FDL 

TEST.FDL 

USER_LOG.FDL 

VLU.FDL 

ARCH_MASTER.FIL 

TEST.IND 


Help file for archival system. 

Help file for Test Engineer code section. 

Help file for Database Manager code section. 

Help file for value file viewer/editor. 

Help file for User code section. 

FDL file used to create master archival file. 

FDL file used to create change log history files. 

FDL file used to create set files. 

FDL file used to create test index file. 

FDL file used to create database user log. 

FDL file used to create test value files. 

Archive master file. Contains data archival information. 
Test index file. An entry is created for each test in the 
database. 


Test-Specific Files 

[.SOURCE.TES7].CHL* 

[.SOURCE.TEST].GEO 

[.SOURCE.TESTj.IND* 

[.SOURCE.TESTJ.MRP* 

[.SOURCE.TEST].PRM* 


Value file change log. All changes made to value file are 
recorded. 

Test geometry description file. 

Label index file. Defines available labels for test data 
storage. 

Contains last offset position in value file. 

Label parameter file. Defines fields associated with the 
labels in the label index file. 
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Table 4.1: (Continued) System Files 


File Name and Path in 
DBDISK:[DBSE] 

Description 

[.SOURCE.TESTj.SET* 

Data set file. Contains a record for each data set defined for 
the test. 

[.SOURCE.TEST].VLU* 

Test data value file. Contains actual test data. 

User-Generated Files 

<file>.RS1 1 

Value Table meta file. This is a meta file containing VALUE 
file data. 

<file>.RS12 

Set Table meta file. This is a meta file containing SET file 
data. 

<file>.RS13 

Label Table meta file. This is a meta file containing LABEL 
file data. 

<session>.XSL 

User-created session log. This file enables a user to resume 
a previous data retrieval session. 
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Section 5 
SECURITY 

The AFAS Database System provides three levels of access to the system: Database 
Manager, Test Engineer and Data-Retrieval User. The VAX system manager must 
assign identifiers to users requiring access higher than User level. The system manager 
creates the required identifiers by executing the Authorize utility from the SYS$SYSTEM 
directory. The commands for adding the required identifiers are: 

UAF>add/identifier DB_MGR 
UAF>add/identifier DB_TST 

The identifier "DB_MGR" is required for a user to gain Database Manager access. The 
identifier "DB_TST is required for a user to gain Test Engineer access. The system 
manager grants a user the required identifier by executing the authorize utility from the 
SYS$SYSTEM directory. The commands for granting the identifiers are: 

UAF>grant/identifier DB_MGR userl 
UAF>grant/identifier DB_TST user2 

Where userl and user2 are valid user names. In the above case "userl" would gain 
Database Manager privileges while "user2" would gain Test Engineer privileges. 

The Database Manager may place restrictions on test data access by "protecting" 
data for specific tests. The test index file "TEST.IND" contains a record for each test 
loaded into the database. The "test_prot" field of the test index record is used to restrict 
User level access to test data. The following algorithm describes the test data protection 
scheme. 

If "test_prot" field of test index record = "P" then 

If user holds "DB_MGR" identifier or 
user holds "DB_TST" identifier or 
username = "test_engr" field of test index record Then 

Access granted. 

Else 

If username = "test_cntr" field of test index record or 
user UIC = privileged group Then 

Access granted. 

Else 

If user holds identifier defined in "test_right" 
field of index record Then 
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Access granted. 

Else 

Access denied. 

End if 
End if 
End if 
Else 

Access granted. 

End if 

Since Test Engineers have access to all test data, it may be necessary to limit the 
ability of Test Engineers to modify test data. The following algorithm describes the 
requirements for test data write access by Test Engineers. 

If user does not hold "DB_MGR" identifier Then 

If username same as ”test_engr" field of test index record Then 
Write access granted. 

Else 

If user holds identifier defined in "test_right" 
field of index record Then 

Write access granted. 

Else 

Write access denied. 

End if 
End if 

Else 

Write access granted. 

End if 
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Section 6 
DATA RETRIEVAL 

The AFAS Database System provides a means of extracting data from the database 
in the USER code section (DATA_RETRIEVAL.EXE). 

The data selected by the user are stored in two arrays - "slJabel_array M and 
"sl_relative_pos". The array "sl_label_array" is a list of data LABELS selected by the 
user. The array "sl_relative_pos" is a list of offsets that will be applied to the VALUE 
file record for each of the selected labels. There are other arrays that are maintained to 
enable the user to create or modify the data retrieval session. 

When a LABEL is selected by the user, the corresponding VALUE file record is 
brought into memory. The offsets in "sl_relative_pos" are always applied to the VALUE 
file record currently in memory. The offsets in M sl_relative_pos" correspond to data cell 
locations in the VALUE file record. The structure is best described by a simple example. 

Given the LABELS RUN, T1, T2 

VALUE file records containing: 

RUN = {10, 20, 30, 40, 50, 60, 70, 80, 90, 100} 

T1 = {1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0} 

T2 = {1.1, 2.2, 3.3, 4.4, 5.5, 6.6, 7.7, 8.8, 9.9, 10.1} 

And the arrays: 

"slJabeLarray" = {"RUN", "T1", ’T2"} 

"sLre!ative_pos" = {1, 3, 5, 7, 10} 

Then the corresponding output table would contain: 

RUN 10 30 50 70 100 
T1 1.0 3.0 5.0 7.0 10.0 
T2 1.1 3.3 5.5 7.7 10.1 

The "sl_relative_pos" array can be restricted by: 

1 . Entering a range or series of ranges for the currently selected label. This will 
remove offsets in "sl_relative_pos" corresponding to values of the selected LABEL 
that are out of range. 

2. Select "valid data only" for the currently selected LABEL. This will remove offsets 
in "sl_relative_pos" for which the selected label does not have data. 

3. Combining 1 and 2. 

The task which provides the Data Retrieval function (DATA_RETRIEVAL.EXE in 
the USER code section) needs to be understood thoroughly, so the algorithm for data 
selection and the corresponding routines are outlined on the following pages. 

• Select option "R - Test Data Load/Retrieval" from the database system main 
menu. This starts the USER code section. 
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Select option "D - Select Data" from the USER code main menu. Call UP- 
DATE_DATA_POINTERS. 

Routine UPDATE_DATA_POINTERS : 

Call OPEN_DBSE to open the value file for the test selected. 

Call OPEN_SET_FILE to open set file for test selected. 

Display option menu to user. 

Display current number of labels and offsets selected. 

Prompt user for menu selection until CNTRL/K entered. 

• Select option "A - Select LABEL". 

Call VIEW_LABELS. 

• Select option "B - Enter LABEL". 

Enter label names until CNTRL/K entered. 

For each valid label entered call UPDATE_LABEL_POINTERS 

• Select option "C - List LABELS selected.” 

Call LIST_LABELS. 

• Select option "D - Select SET.” 

Call VIEW_SETS. 

• Select option ”E - Enter SET.” 

Enter set names until CNTRL7K entered. 

For each valid set entered call 
UPDATE_SET_POINTERS. 

• Select option "F - List SETs selected.” 

Call LIST_SETS. 

• Select option "G - Edit current session.” 

Call WRITE_SESSION_FILE to write current session log. 

Call EDIT_SESSION_FILE. 

Close value file. 

Close set file. 

Return to caller. 

End routine UPDATE_DATA_POINTERS. 
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ROUTINES 


Routine ADD_UNBOUNDED_LABEL: 

If label not in "sl_label_array" 

Increment sl_numjabels. 

Load label into "sl_label_array". 

Load "sl_no_range" flag into "sl_lower_bound" array. 

Load "sl_no_range" flag into "sl_upper_bound" array. 

Set "sl_ranges(label_pos).num_ranges" to zero. 

Set "sl_ranges(label_pos). nonulls" to .FALSE. 

End if 

Return to caller. 

End routine ADD_UNBOUNDED_LABEL. 

Routine CVT_TOKEN_ATTR: 

Convert string to appropriate binary data type. 

Load I2_TYPE, I4_TYPE, R4_TYPE, R8_TYPE or string size for 
character data into "type". 

Return to caller. 

End routine CVT_TOKEN_ATTR. 

Routine EDIT_SESSION_FILE: 

Get editor symbol for user-defined editor. 

Spawn edit command. 

Call INIT_SESSION. 

Call READ_SESSION_FILE. 

Return to caller. 

End routine EDIT_SESSION_FILE. 

Routine ENTER_BOUND: 

Read input value string. 

Call CVT_TOKEN_ATTR to convert string to proper data type. 
Return to caller. 

End routine ENTER_BOUND. 

Routine ENTER_RANGE: 

While last character of bound value .ne. "+" do 
Prompt user for upper and lower bound values. 

Call ENTER_BOUND. 

Increment "n_bnd". 

Increment "bkt_pos". 

End do 

Load "sl_ranges(label_pos).num_ranges" + 1 into "labjng". 
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Load "n_bnd" into "sl_ranges(labeljDos).num_bnds(lab_rng)". 
Load "range_bkt_size” + 1 into 
"sl_ranges(label_pos).rng_ptr(lab_rng)". 

Load "range_bkt_size" + "n_bnd" into "range_bkt_size". 

Load "lab_rng" into "sl_ranges(label_pos).num_ranges". 
Return to caller. 

End routine ENTER_RANGE. 

Routine FINISH_SESSION_FILE_SCAN. 

Close session log file. 

Return to caller. 

End routine FINISH_SESSION_FILE_SCAN. 

Routine GET_SET_LABELS: 

If set name has been loaded previously return to caller. 
Increment "sl_num_sets". 

Add set name to H sLset_array’’ session log common. 

For each label in set file call ADD_UNBOUNDED_LABEL. 
Display current number of labels and offsets selected. 

Return to caller. 

End routine GET_SET_LABELS. 

Routine INITIALIZE_SESSION_FILE_SCAN. 

Get LUN for session log file. 

Open session log file. 

If cannot open session file then free LUN. 

Set "scan_cur_pos" to zero. 

Set "scanjength" to -1 . 

Set "scan_line_num" to zero. 

Return to caller (Return open status). 

End routine INITIALIZE_SESSION_FILE_SCAN. 

Routine !NIT_SESSION: 

Set "sLnumJabels" to zero. 

Set M sl_num_rrefs" to zero. 

Set "sl_num_sets" to zero. 

Set "sljnitjabel" to .TRUE. 

Set "range_bkt_size" to zero. 

End routine INIT_SESSION. 

Routine LIST_LABELS: 

Display labels and ranges in current session. 

Allow scrolling of list. 

If an entry is deleted then 
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Remove "sljabel_array" entry for current label. 

Remove "sl_upper_bound" entry for current label. 

Remove "sl_lower_bound" entry for current label. 

Remove "sl_ranges" entry for current label. 

Decrement "sl_num_labels". 

End if 

End routine LIST_LABELS. 

Routine LIST_SETS: 

Display sets in current session. 

Allow scrolling of list. 

If an entry is deleted then 
Remove "sl_set_array" entry for current set. 

Decrement ”sl_num_sets". 

End if 

End routine LIST_SETS. 

Routine PROCESS_LABEL: 

Load ”sl_upper_bound(label_pos)" and 

"sl_lower_bound(label_pos)" with appropriate flags or 
range values. 

If label is first label to be processed then 
Build ”sl_relative_pos" array for current label and range. 
Else if label range specified 
Set "sl_relative_pos" array offsets that are out of 
range to zero. 

End if 

Call SHIFT_ARRAY to rid "sl_relative_pos" array of zero 
valued entries. 

If measured data accessed 

Call CHECK_VCOUNT to get rid of any "sl_relative_pos" 
offsets with valid count nonzero. 

End if 

Return to caller. 

End routine PROCESS_LABEL. 

Routine READ_SESSION_FILE: 

Call INITIALIZE_SESSION_FILE_SCAN. 

Read label from session file. 

Do while labels present in session file. 

If label is not in list call ADD_UNBOUNDED_LABEL. 
Increment "sl_ranges(lab).num_ranges". 

Load "sl_ranges(lab).num_ranges" into "mg". 

Set "sl_ranges(lab).num_bnds(rng)" to zero. 
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Load M range_bkt_siz9" + 1 into "sLrang 0 s(lab).mg_ptr(mg)". 

Do while ranges present for current label. 

Increment "sl_ranges(lab).num_bnds(mg)". 

Load "sl_ranges(lab).num_bnds(rng)" into "bnd". 

Increment ”range_bkt_size”. 

Store current lower bound string. 

Call CVT_TOKEN_ATTR to convert string to proper type. 

If upper bound specified then 
Store current upper bound string. 

Call CVT_TOKEN_ATTR to convert string to proper type. 

Else 

Load current lower bound into upper bound. 

End if 
End do 

If current label is initial label call PROCESS_LABEL. 

If "valid data only" specified call REMOVE_INVALID_OFFSETS. 

End do 

Call FINISH_SESSION_FILE_SCAN. 

Return to caller. 

End routine READ_SESSION_FILE. 

Routine REMOVE_INVALID_OFFSETS: 

Load ”slJabel_array(label_pos)" into "labeljd". 

Make sure data for "labeljd" is in memory. 

Remove offsets in "sl_relative_pos" that do not have valid data. 

Shift "sl_relative_pos" array to remove the invalid cells. 

Decrement "sl_num_rrefs" to reflect new "sl_relative_pos" array size. 

Return to caller. 

End routine REMOVEJNVALID_OFFSETS. 

Routine TOGGLE_NONULLS: 

Set "sl_ranges(label_pos). nonulls" to logical opposite. 

Return to caller. 

End routine TOGGLE_NONULLS. 

Routine UPDATE_LABEL_POINTERS: 

If wildcard character in label name 

For each label matching wildcard search call ADD_UNBOUNDED_LABEL 
Else 
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Call ADD_UNBOUNDED_LABEL. 

Prompt user for range specification. 

If range specified call ENTER_RANGE. 

If "Valid Data Only" is specified call TOGGLE_NONULLS. 

If label loaded is first to be loaded or a range has been specified call 
PROCESS LABEL 

If "valid data only" specified call REMOVE_INVALID_OFFSETS. 

End if 

Display current number of labels and offsets selected. 

Return to caller. 

End routine UPDATE_LABEL_POINTERS. 

Routine UPDATE_SET_POINTERS: 

If wildcard in set name 

For each set matching wildcard search call GET_SET_LABELS. 

Else if "ALL" specified 

For each set label in set file call GET_SET_LABELS. 

Else 

Call GET_SET_LABELS. 

End if 

Return to caller. 

End routine UPDATE_SET_POINTERS. 

Routine VIEW_LABELS: 

Display list of available labels. 

Select label from available labels list until CNTRL/K entered. 

If label selected from list call UPDATE_LABEL_POINTERS. 

Return to caller. 

End routine VIEW_LABELS. 

Routine VIEW_SETS: 

Display list of available sets. 

Select set from available sets list until CNTRL/K entered. 

If set selected from list call UPDATE_SET_POINTERS. 

Return to caller. 

End routine VIEW_SETS. 
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Section 7 

THE SESSION LOG 

The session log enables a user to store the current retrieval session, resume a 
previously stored retrieval session, or modify a retrieval session. When a user begins 
a data retrieval session all information pertaining to the current session is maintained in 
memory. The user may select to store the current session at any time or may edit the 
information stored in memory for the current session. Appendix D describes the session 
log file format. 

• Storing a data retrieval session. 

The user may store the current retrieval session by selecting option "S" from the 
main menu of the USER code. The user will be prompted for the session name. 
The extension should not be part of the session name. A file <session_name>.SL2 
will be created and will contain all information required to resume the session. The 
user will also have the option to create the session log when terminating the retrieval 
session. 

• Editing a retrieval session. 

The user may modify the contents of the session log by selecting option "G" from 
the "Data Selection" menu. The "Data Selection" menu is presented when option 
"D" is selected from the USER code main menu. When option "G" is selected the 
system spawns the editor defined by the symbol "DBS_EDITOR" and opens the 
session log file. The session log may also be modified offline by any text editor. 

• Resuming a data retrieval session. 

When starting a data_retrieval session, the user is prompted for "New" or "Previous" 
session. If previous session is selected the user may enter a valid session name 
or select a session from a list of available sessions. When a valid session name 
is entered the information contained in the session log is loaded into memory. The 
user may now resume the session from the point that it was stored. 

• Initializing the current retrieval session. 

The user may initialize the current retrieval session at any time by selecting option 
"I" from the USER code main menu. This will return the retrieval session to the 
"New" session state. 
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Section 8 
DATA ARCHIVAL 

As the volume of data in the AFAS Database System grows it will be necessary 
to archive tests that are no longer accessed on a regular basis. An archival facility 
has been provided to enable the Database Manager to archive selected tests to optical 
media and/or magnetic tape. 

The archival system allows the Database Manager to archive selected tests and 
either delete or retain the archived test in an active status. After a test has 
been successfully archived, a record* is entered into the archival master file (DB- 
DISK:[DBSE]ARCH_MASTER.FIL). The test index record* in DBDISK:[DBSE]TEST.IND 
corresponding to the archived test is also updated to reflect the status of the archived 
data. The first six characters of the archival media label are entered into the "arch_m_vol" 
field of the test index record. The status of the archived data is recorded in the 
"arch_m_flag" field of the test index record. 

The possible values for "arch_m_flag" are: 

0 - Data not archived 

1 - Data archived and retained 

2 - Data archived and deleted 

If engineering data are available for the archived test the fields "arch_e_vol" and 
"arch_e_flag" will be updated as well. 

If a user selects a test that has been archived and deleted, a message will notify the 
user that the requested test has been archived and is not available. The user should 
notify the Database Manager to have the test restored. 

The Database Manager restores an archived test by selecting the restore option from 
the archival menu. If a test has been archived more than once, a list of archival sets is 
presented. The Database Manager selects the appropriate archival set from this list. 


All record fields for all files are defined in Appendix C. 
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Q Q 


I Z 

Z X X X cd 

o o o o a 

►■* Cm U* Cm X 

i CO ■ • • U 

I !rt < < O «1 

i fd H H O I 

' co < < A X 



>i 

3 


X 

cd 

CO 

3 



C C 


3 3 3 

C C C 


33333333 

cecccccc 


UdUUUUU^UiJdddJiJdiJJiJiJiJ 

333333333333333333333 

000000000000000000000 

93 99993333333333 

U U J J U 


, ^ ^ ^ w _ _ _ _ _ _ 333 


>, >» >^ >■ >« >^ 3»< 3^1 3^* >-• 3^* 3^* ^ 3^* 3-* ^ »» 

HH-tHHrHHHHHHHHHrHHHHHHH 

i, * _4 _4 —j ^4 H ^4 *H H ^4 ^4 -H H ^4 ^ ^4 ^ 

3323333^-0^^^232232255 



222222222222222222222 


XHXcoXX XXXXXXXXXXXXXXXXXXXXXXX 
S<xhx> xxxxxfflxxxxxaxxxaaoxxxxxx 
JQ 2S JN J J J J J J p4 J J a J a *4 j j j 

to'vi'co’S co®5 5 w'cn'sn’w'w'w'crt'tn w M « « 2 W w « w w w w w w w 


a Q a X Q 


«aauainDaiiaj!flafliuflsfl555SS5S 

ixQQQQQQQQaQQOQOOQClQaQQQQ 


I IU Z 

zuuou 

222 J i2 5 

< A | IX U Z 

w» H H X W,l 
U1 X X Ml ix 

O CO (O 3 S O 

, i i i i< y 

22§3i£ 

222222 


999 99393 

CCC C C C C C 
*1 ^ C »H H -H »4 H 

U U J O J J *J J U 
333-H33333 

oaouaoooo 

333 53333-1 

oooviutiooaio 




X 

o 


X ? X • oc S! 
O j O H O H 
Cm ICm p*4 Sm cd 
• cd • X • > < 
cd £ cd Cd cd *-* 
D 5 3 PS 

5S23I32 

H O X O X O < 


4-» -J 

3 3 
0 O 

U M 

33 



X 

a 

Cm 

XXXXXXXXXXXXXXXXXXXXXXX 

iHOOOOOOOOOOOOOOpppppppp 

I MCdCdCdoJCdCdCdMCdCdCdCdCdtdatdCdCdCdCdW 

11112233333333322222322 

CO CO CO co CO CO 
X X X X X X 


^^^^^COCOCOCOVT|COCOCOCOV}COyj 
■ .fldxoJXXXXXXXX 


xxxxxxxxxx 2 xxx 


5S a 

"itd’xa OO 

Cd H CO CO U X 


S3 

xg g j 


co to cd 3 

b* Z «-• a 

2 23 u < 

_,JXX H«X 
qhHW^'jJXXQCO 
_ liiuaidyOHX 

2 vi d - if-»HHxyyz . i. ij 9 9 3 2 
2 o-ZH^mwu222Hha 

OJ'4J-<jlZ<< 34C<i4dj)^2 3 U Q 

3 i 4 OHj4JS£OnnH3 i I 
ii iiii 

^OCOCOCOCOCOOCOCOCO^OCOCOOCO^COO 

xxxxxxxxxxxxxxxxxxx 

9 9 9 

c c s 

coccscccccccc-^-^t^ 

ooooooooooooou^^ 

UtiJUiJJUJUiJyiJJ 0 0 0 

OOOOOOOOOOOOOMMM 

= =C=C = C= CCCCC^^^ 
*4 4-14-1 « V» O 


55 


3 3 


3 3 


31 

o o 

as 

>* J J 

*-• < < 

ill 


CO co CO 

XXX 


-J *J — » 

3 3 3 
OOP 

M M W 

g a a 

3 3 3 
O A A 


A - 6 


u U U U U J J iJ J ^ 

3333333339 

0000000003 

MUMUHWMMUfl 
r* 4 

ij j iJ J u a u 

w to w w to to <o 

9 3 0 9 9 9 9 


u U U ii J ii J J u H U H -H 

99999999993 9 

dddddddd d> ® a > 

eeeeseses^ncu 
0000000009 
oooououuo 

9 

It— *r- 4 >— 4 »—*r-« M 90 
'vNN.N.V.NV'v.^ 03 ^ ^ 

2222222225 ! 



0» > 9 O 

o» a* -u — * ■ 

0 O 9 C 
H U Q D 


nCXXXXXXXXHXXXXXHH 
cacacnaDiacnoaca.a-iaaxcQaaci-C-c 
4 Jd J J jq J JJ 
I I 


X X X H 
^ 03 > cQ < 

X . ^h4Q 


51'H' JS»3'K3'S-S‘l'H'i IlllliliS ! I II II I’ll I'i'i'il I 

QQQQQQQaQaQQDQQQQOaQaQQQOQ<33QDQ<QOOaQQQ*Q 


2 

9 

<-H 

9 

jJ 

9 

-o 

u 

0 


aC dc ac ac to aC 

O 03 03 03 H 33 
£ 4 4 4 £ iJ 


TJ 

■o 

9 


a 

9 

a 


DC 

X 


DC 

X 

X 


03 

a 



ac x 

3 “ 


cd 

J 3 S 
ac 1 iac = 

u <n co 4 o 

cO 03 X to QC 

3 O Q 3 < 


ac 

O 


to 

DC 

Cd 


3 

X 

D 


D 3 
CO 

Z 

a to 

X 

X 

O 

Cd 

X 

— 

«-» 

t"* 

H 

z 

z 

<-4 


Pm4 

CO 

0 

0 

O 

X, 

X 

X 

1 

1 

-4 

< 

X 

X 

H 

< 

Q | 
X X 

a 

*1 

X 

3 

1 

X 

CO H 

H 

H 

< < 

< 

< 

U Q 

O 

a 

X X 

X 

X 

3 3 

3 

3 


ac 
ac o 

O Cu 
x • 0C 

• o 

.. -44 X 04 

ZCZU • 
»m o i-t H Cd 
Obu4Z4 

x • 

|< H O 6 m, 
4 H U 4 I 
X < 44 !H 

x a 3 H <0 

2 led Cd Cd 
d ^ W) ifl H 
ICO I I l 

Cd X cd cd Cd 
H It-* H H 

< q < < < 

q < a a a 
a* O x x x 


cn 
Cd X 
Z X 
N-* S-I Cd 
*4 -4 

Z H O X, 
X O X I 
X Cd i H 
X 4 h 
CJ Cd Cd Cd 
I/) 1/1 l/J H 

I I I I 

Cd Cd Cd cd 
H t- H f- 
< < < < 
Q X Q Q 
X x X X 
3 3 3 3 


9 9 9 9 
9 C C C CCOC 

—4 c — — — C — • — — — 

Su-LJ-UU-dU-LiU^I 044U044J4 
-.333333333—333—3333 

t 5222222222 o 222 ti 2222 
§333333333 §333 5 -M 33 

^ iOOtOWOO 'OW'O— OttfO'—iOO'OO 


c 

o 

— 

u 

u 

c 

3 


3 3 3 3 
OOOO 

U M M M 

333 3 

rt vi ai o 


A - T 


<— < a s 

-» < o iJ - 

o u a 
M ® T3 fl 
CJ -* 9 
91 “O U 9 
C O tf» - 
*0 9 9 
C X *1 9 


^ 9 9 2) 
>T3 C C 


4 M 9 9' 
"O j j u 


• -• u 

tt X 3 

u a 

a o» -»-» i 

t/i c a » 

«M -H 0 < 

<M </» • < 

O 3 V 0 ( 

w i 

9 >. o 

jj <n u w i 

a m a» <d i 

“O M M *M <■ 

9 <M 
■o <-l 3 I 

H (J' l 'l 

r»^H c > 

: «ti -h *4 a 
l > W JZ 3 
i C U O 
m n w 

I <4 > 

9 JC 

I > U 9 9 
3 u j j 

) g 9 * 

I J ® U U 

> as c/i x x : 


I |Q rrj M M W 

> > S u J 

i C C 9 9 9 

► «•-♦ W M M 


U U U M U 

jj ju: 


aC u 3 flC M X w 

3 S i3S3 5 

IX Z IX IX X 


oa fl>fl osiajafl 

_4 4 h J 3 ^ 


ato<xxxui2^xtoxxxxxxxxvjaa 

SSlQiQ3oa3Q<Q QQaQa3QQ 


S x o S 

lu Q ! 

X ’i. 4 4 

(J li. t CO 

!235§ 

j g-* H £-* H 

\ X X X X 

£ Z X X X 


j u J J 
3 3 3 3 

o o a o 

Li kt la L» 

3333 

i « wl A A 


a a j « afi l 

H 5-* W vj tX 

> > 33 (fl H Ul 

z 2 < a a M 
hh4uiv)3 
I I t I I I I 
Ci3 sd £*J X 3d UJ 
!-» H E-» H H H 

■_* »h ■— • >-» — i 

31 X X X X X 

X X X X X X 

9 9 3 9 9 9 

c c c c c c 

— «♦ *»t •«'< —« 

J J J U iJ 4 

3 3 3 3 3 3 

0 0 0 0 3 0 

u 1-4 L» Ll L| LI 

333333 

/I ui /i a « a 


A - 8 


REN/ITECI — I 


RTR 193-04 


Appendix B 

DATABASE SYSTEM ROUTINE ARGUMENT LISTING 


B - 1 



Record structure. 


i i i i i i i i i 


a. C « n <t v as «-< J tJ 

w 

H o 

t u 

9 

9 X 


n -h T3 "0 

9 “O 9 9 

(J Q -H H 

U S ’M »M 

^ TJ 3 

fill 


§111 
M 0 < 0 * 0 » 

u u u 
9 9 9 9 
XZ 

U I I I 

« « « n 

9 ai *J1 A 
*J 9 9 9 
O O O O 

c u o o 

9 9 9 9 

>• >* 9 
"O *-» U 
r-l C C ^ 
9 O O M 
-*-i X 

v* 9 '“>> 

V V 

B 9 9 

«1 9 M 9 

9 X X X 


c c/i 

i ^ ua 

i q • 

: T> q T3 

19 • -3 

I C </l U 9 

l -H 3 Z •«"' 

| *4 *J H i 4 

'99 
*0 i_> C >i 
: — !/> -♦ 9 

) . .* 

< « c T3 

> 3 O 9 T3 

> i-» -H C O 
: 9 U 'A 

3 4J 9 *-< 

4 « 9 9 

0,0 a 

ICS'-' 

10 0 w ( 

i -t O ® O : 

i u a, 

J 9 g >• -C « 


a /-* ■ s 

“0 

C O Cl 


CT> -h T3 9 O' - 
c 9 9 9 C 9 - 
<h J T 3 M wfl 
W 9 V □ M 9 - 
— i 9 n u h 
v) « 


3 9 C O O* 9 C 

c O 4-» « c o * 

9 v 4 -^4 

> H iJ 9 *0 ^ 4J 

9 -H 3 9 ^ 

>* O « h u J 3 »i 
3 9 O 9 2. 9 O 1 

as J flu > Wl O Oa I 


T3 T3 ^ 

:U 9 9 i 
D J J 
X 9 9 ' 

f-l -r -4 "H ( 
• > > * 
9 t < 

C 9 9 ' 
i 0> -0 O ‘ 

r-» 9 t 

-* O O J 

>,M J U ! 

9 

; ~l 9 >* >* r 

I a c 9 9 ! 


1 0 » Jj iJ 

.c c u o , 
j-> «H 9 9 
Oi,-* w w 
C 9 9 
9 9 XL J3 
O U U U 


X X XX 

v N, N. v 

xxxxxxxxxxxxxxxxxxxxxxxxxxxx 


OOS 4 frMM^INN« « 


T3 
9 — * 

a l c 9 

u *j O O C 

3 31 B* Q 9 

0 9 *■» 3 g,-« : 

999399rt-u UUU t I C 

c C C C C C I |CC99>»>'J 
OOOOO OCC334J*J»9T 
ZZZZZZ-^^^-»'»-» 9 «*■*•»< ‘ 


1 O' 

age 
0^9 
J ^ H X 

* ttig- 

; C C 9 § 

I U M c c • 
i O O -« •£ 

I A 91 H g ' 


I H H X >* O X 

i h < *j < z y 

• a a £ -3 y c 

: id i !& £ 3 3 
i [cn ui </i 1 **-» 

; a a 3 — z >u 

a o o o ►* o 


B - 2 


Vdluo 


© C. JZ • 
o 4 J O’ 
«H C 
<W > J -H 


6 T3 

m a u 

0 3 0 

• «M o 
c c <n 9 
© -* > w 

AJ 

U T 3 > 3 
-h M © 3 
U O C -* 
> U © 
© © S > 
W4 U o 
u * 
a 9 ki 9 

i5 3 c 

o -a o c 

» > tj 


c O' J « 

® C M -« 

3 -rH o -4 

M W4 Cu I 
o -u OJ -< • 
IA (A M 9 

> 0^9 
U £ O h 

,-4 ® S 

a c c 

t/J O «M ' 

— t jO — » 0 
T 3 M u 

o — « © ■ 

a a « m 

£ © o — » • 

* u) as a* u> . 


i .a m § = 
I 1 ) M 3 3 
-4 < Z Z 


*0 o o > c 

Ul !/| trt -H <5 

© j= e 

o >i >* u e 

J 9 9 U O 

3 — i <— t aj U < 

u a a, 

E /9 Jl A >* © 
^9 ^ ^ 9 ^ 

a, t 3 tj *“• ■*■• ' 

22 a S’ i- 

</) V) (/) Q < 


o o a u 

S 2 S 

V> V 9 W 9 < 


2S23 3 

i/l »(/)Xv)i 


J S 53 * * ** 

fleDCflCDCtfccuaSafifllPialKaSxacaiitassssaiKaiasaiaCtfSSaCafiSSaiafiJ 

m jn 

VHNNH^NNNNNH* * N»¥HNn2vNCM<NN«¥« JJ»»J j fj 2 ~ Z tJ 


«-l u 

o c 

O i 3 
a o .c © *0 o 

«_> 3 K a 1 u *-*3 0 

<9 rt O *-» O l !o» i Cn | 

»M^M 9 Ua£CC © C -* _ 

3 — « r-4 |tl 9 a J 9 3 « © —* “T3T3M 

| a, A I® A : J J-'H B'O o 

n > »-* i i i i © ^ © 0 -* i ij-* 


TJ © T 3 _ 

\ U —4 T 3 • 

> I O !—• 
|13*J J C T 

i ** « c *4 “3 

i a © o u J5 , 

: o. m z © j< 


B - 3 


target C* K String to be 

subroutine CALL_DB_EXIT None 


o o 

I • I 

# TJ 3 

H 3 -h 

■*-t M -4 
%4 


a u 
U * I 

o a 
a a * 

- “3, 

«m a | 

«i a • 

«A 3T3 
3 ^ C M 

-4 I» O 

ax o 
> a o ® 

Cum 

a > c 

.c *-* a 

4-> C — • 
—4 Tj — ♦ 
O' a h-i ; 
c c T3 : 

-4 O 1 D • 
C w O 3 
— i U —t <-* 

■ a -* a ' 
I j « n > 

i C O -« 1 

O Cli'M M 

i u a o 

I U l) w 

I >« 3 ■ 

> a a *m t3 ' 

| V4 4-4 0 ' 

iw w a ' 
) a o n -• 

: a 'w 

a <-• jQ 

)*-»—•£ 

: >, a 3 a 

> aq u 2 16 : 


as jsiasxasciflcaxats 


c c c 

a a a 

a a a 

U MU 

o o o 

tf> n « 


o o 

u u 

« JN N N « N 




Ml K4 ►-» H hHHHHJHHHH 


u u C 

ii 4J a x 

* W <“• O 

ill M 
*j a a T9 i 

a u o -mu 

(7 M W H |M 

M 3 3 ~4 M M 

a o o a a 

*i n « » o o»w 


o 

X o c ^ 

O 13 3 
M iJ H 3 

4-i* §* a* a 
n o n 4 -» e 
a m h >% a 

<H 0,^ H 


tj a 

an u a m n 4 J 
a a a c a «m a 

U H U o 4j u 4J 

n -w n z « o n : 


Q 

-4 

Ci3 

*1 S £ 

3 O I 
OJ U U 

32 2 

x 1 as 1 x 


» a -o a *j o 
i-4 I i~» 3 3 I* 
I l-o C I I « ^ 

I u M M "3 X >M — • 

I 3 J ua 3« 9 

i m Ot » c 3 o . 


IT9 TJ 

{J1 —4 —4 

o t 

<-4 c z c 

I M Ci) M 

fio 2 o 
o n x n 


*: i f-» 

(J X U3 

< CU X V) 
y> jj 1 

VJD3X 
I 12 2 

< Si “3 
3 S § 1 

u u o u 

a 3 

c c 

C -* 3 'H 
o *j 0 M 
-4 3-4 3 
4-1 3 M 3 
tJ M U M 

§3 §3 

M 71 M « 


TJ'O'OTJ M *0 T3 Tj *3 

“fl »4 -4 -4 — 4 Q — 4 -4 -4 —4 
—4 I I I l-U III 
ICCCC^CC'OC 
4 JMUM- 4 CMMWM 

aocjuaouo^o 

9nnn56nno.a 


u <j X, 
tn tn 1 
leu i 2 
J >* «“« 

U1 M U3 < 

^l^l^l^l*! 
3d Cl] Cl] Cd UJ 
H H *-* H 
< < < < < 

2 2 2 2 2 
o u o u u 


3 3 3 3 3 
C C C C C 


33 33333 333 

OQ 00300 OOO 
uu MMMMM m m m 

33 33333 333 

n 7) n n ft n n *> n n 


B - 4 


kkxl I d 14 R SMG keyboard Id. 

Vd lld B W Valid Input flag, 

subroutine C HEAT E_RPT_SC KEEN rpt_id 14 w SMG dl5 P ld V screen id 


cn 

O' 



3 

3 



M 

M 



c 

C 



M 

^4 



TJ 

■0 



. . 3 

3 

• 


1 O' M 

M 

“0 

* 

M C M 

M 

3 

s 

3 M 3 

• 3 

M 

O' O 

> M > 

O' > 

M 

c -• 

! M c 

c c 

3 

M 3 

M «1 0 

M 0 

> 

M 


• 3 

> <n 

•m Cm 
o o 3 

\ O M 

. c o 

tj O “O 3 
r-t M 

M 0 3 
CO JC xz 
3 a» O O 

® w w O _ 

M3 M "0 
O O TJ m 

VI M M M 

C 3 3 3 
>, u. 0 ^ > 
3 3 -Q *-• 

— t *J 3 3 '•-t 

a moo 

« o « 

~4 U 3 O* M 

*0 a c <v 

O* n 

V) Cm V) v) Z 


• • -a * 

*o >• » -o • 

3 3 ® « 

M M C M 
U M M 
3 3 3 - 

> vi > 
Ci 3 C 
O VI M O 
U 3 >i O 
M O 

3 >» 3 

0 0-30 

• M 

o — * o 

4-> H-» 3 M 

o > 

>• o 

3 3 m -< « 

m a, o 3 

M >1 — < 

3 M M «-t 

3 

3 3 0 3. 


3 U • M O * C M 
MO TJ M 3 o n 
• u T3 h cnTj^O* 
M 3 M 3 
C , 00'*^00‘M3C 

-H 3J='M4JO'MO*M 


m m O* T3 
3 M C 3 

> M M 
c J M M 

O M3 
O M V) > 

3 C 
3 O TJ O 
O M 3 O 

M 

o 3» M 3 

M C 3 O 

M > 

i 3 M C O 

I 3 M O M 

-t n o 

3 3 

I > M <M 3 

i 3 O m 

MM 3 
i 3 O XZ > 
\ O' 3 M 

I 3 M O'*-* 

M 3 C 3 


3 M 3 M 
M 3 0 

M Ifl H 
3 3 M 

XZ -0 > 3 
M3 -C 
M O' O 
O* M C 
C 3 M “O 
M > C M 

M c M 
M O 3 3 

VI O M > 

c 

U M O U 
3 0 0 0 


O v» •at 
3 3 — 

M M t M 

m > d u 1 

3 O 3 C 

> B M M j 

C ~ >• 3 

◦ O M 

o *o ■ a 

M M 
O' 3 _ 

C M TJ M 
O 

C 3 
H 3 M (0 . 
3 M 'M 3 
M3 M 
C TJ 3 3 
O MM 

». ° C • 
3 3 <M ◦ 

m a o m 

M > M 
3 M O 3 


000'M3M03 
3 M C 3 MM 

M O' m O 3 3 O* O. ■ 

3 C M £5 M M C 6 

JZ 3 M 3 >1 3 3 0 

uMvizcoaou 


3 3 

M *0 

%4 0 • 

C O' 

3 m n c 

> M 3 M 

1 3 V> M M 

l *0 3 3 M • - 

I M M VI M 1 
I «M >1 W C • 

' °- a C 5 1 

I 3 'W O M 3 

I Q, 0 m 3 m 

I >1 M > 3 

> M M 3 _< 

\ 

: M 1 i* 3 3 

> 3 3 0 M M 

> Q Z U Cm Cm I 


SEaSXJJDCXSiflCflCflCIXCCJISJJCCaCJflSDiJSflSIDCflJJlSJ^l 1 !! 

TJ -0-0 

U MM 

O OO 

8 00 

"T « ^ MSN <\l « 'T <T « V « f « V ^^«^3 , N ^ 3 r! N - 

HUMUHaaUHXHUHUHHUHCCU'-'UHaUHHUHKUHHUXUHa 


6 

O C M M 

M 3 0 3 

TJ a* M <M M M c 

<•1 O* C XZ I I «4 3 3 

| |C«» - Mfl^fl l >M 
3 "0 3 6 O' M m m tJ 1 i 

*OMMMMMC3333MME 
OOmm >.0 » m -h m 3 33 : 
1 g Q,3» «o*-»mvi«m»mM MO C 


1 O' 3 

1 O' C XZ M [ 

I C 3 3 M 3 i 

{M M 3 6 O' I- 
: M M *J M c M i 

I M M >» O 3 > 4 

t n » O 'm m o i 


> I g S 3 3 

M M 3 M M Q, 
> M M O M >• 
O V) 3 <M A M 


J «-3 
M J 

zoo 

z 2 at 36 
U U O U 

VI V) V) V) 
11)1 
Qd Cll U1 U 
H E-* H 

< < < < 

u u u o 


3 3 3 
0 0 0 
M M 1-4 


I V» « V» VI VI 


B - 5 


stat 14 W Conversion compieLioi 

function DAIE_VALID date C9 R Date to be validated 


“0 T3 z 

3 

c • c • 

<0 ® XI « 01 n 

a> 6 — * • « 3 vj 

m m tj m u a 
O CTJH o <fl o 

A U 01 U O 

<9 n *0 (A 

>mU o M >» 

m H IQ H C 3 

^-t <W ® 0 ■“< 0 

i Q* U A Q.*-* "H 

» c >i >< n u 'm 
i w o H « *h « 

I V CUM *0 r* <9 

in Q« 3 

i U n o « S <-* 


;53i82 


OS X OS X OC X 


cxjocxalaSaeaSaiaSaSaCaSaScSoSDSaePCaSaeeGPSaSaSXaC 


X >-* *r (N » <N 

H J H H H M H 


« « (U < N 0 f ^ ^ ^ ^ ^ 


« u I U 

in n 3 u 

4 U 4 U 

^ n ^ w 


w i u - 
nun 
O ® u 
z a, n n 

O 


g n u 

X i T3 XTJ m- 3 u JT3 
-m c -h T3 -h -h O -* O 0*0 
I I Ml lu 1 u urn 

C«C |^ C -* e II 


n *o_ -a a 

— « — ♦ 13 <** 

I f M I I 
c 6 *3 | e u ® « 


r^iuuu*rtv4^c-«c6-acMiM*3Mnnc 

i o u *4 « o-goono u c ,□ £ t> u 3 o 

iyn<Mnj<a6asacM^invia.j<nn*dz 


33 
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Routine Name Argument Typ« Access Description 
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Appendix C 

DATABASE SYSTEM FILE RECORD FORMATS 



AFAS DATA3ASE SYSTEM HELP FILES 


<code_section> . HL? 

These are help files for the corresponding code sections. The files 
contain eighty column ASCII text records created by editor. Help entries 
are defined by creating a help "tag" followed by the associated help text. 

A tag is created by inserting a followed by a unique help path string, 

Each oath entry in the path string must be a single character and path 
entries must be separated by a period. An example of a valid help tag is 
W #1.A.G". Any text lines following a help tag are associated with that tag. 
The help text for a help tag is terminated when another help tag or "#end” 
is encountered. 


FILENAME : [DBSE] <code_section> . HL? 

TYPE : Sequential with variable record length. 
RECORD LENGTH : Maximum 79 bytes. 


FILENAME 
TYPE 
PRIMARY KEY 
SECONDARY KEYS 
RECORD LENGTH 

FIELD NAME 


volnam 

src_te3tid 

saveset 

media 

date 

text 

comment 

relpos 

filler 


MASTER ARCHIVAL FILE 

[DBSE] ARCH_MASTER.FIL 

Indexed with fixed record length . 

volnam 

src_testid 

200 bytes 

TYPE DESCRIPTION 


char*12 
char*17 
char *17 
char*20 
char *9 
char *60 
char* 60 
integer*4 
byte 


Archival volume name. 

Archived 30 urce/test_id. 

Archival save set name. 

Archival media type. 

Archival date . 

Descriptive text from test index file. 
Archival comment field. 

Position of save set on archival volume. 
Used to fill record. 
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TITLE 
ID ENT 
SYSTEM 


FDL FILE FOR ARCH_MASTSR . FIL 
"File Name : DBDISK: [D3SE] ARCH_MASTER. FDL" 

" 9-AUG-1990 14:21:54 VAX-11 FDL Editor" 


SOURCE 


’VAX/VMS' 


FILE 


NAME 

ORGANIZATION 


’dbdisk: [dbse] arch_master . fil* 
Indexed 


RECORD 


CARRIAGE_CONTROL 

FORMAT 

SIZE 


none 

fixed 

200 


AREA 0 


AREA 1 


AREA 2 


ALLOCATION 15 

BEST_TRY_CONTIGUOUS yea 

BUCK£T_SIZE 3 

EXTENSION 3 


ALLOCATION 6 

BEST_TRY_CONTIGUOUS yes 

3UCKET_S I ZE 3 

EXTENSION 3 


ALLOCATION 12 

3EST_TRY_C0NTIGU0US yes 

3UCKET_S I ZE 3 

EXTENSION 6 


KEY 0 


CHANGES no 

DATA_AREA 0 

DATA_FILL 100 

D AT A_KE Y_COMP RE S S ION no 

DATA RECORD COMPRESSION no 


DUPLICATES 

INDEX_AREA 

INDEX_COMPRESS ION 

INDEX_FILL 

LEVE L 1_IND EX_ARE A 

NAME 

PROLOG 

SEG0_LENGTH 

SEGO_?OSITION 

TYPS 


yea 

1 

no 

100 

1 

"Volume name” 
3 

12 

0 

atring 
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FDL FILE FOR ARCH_MASTER . FIL (Concluded) 


KEY 1 

CHANGES 

DATA_AREA 

DATA_FILL 

DATA_KE Y_COMP RES S ION 

DUPLICATES 

INDEX_AR£A 

IND E X_COMP RE S S I ON 

INDEX_FILL 

LEVEL 1_I ND EX_AREA 

NAME 

SEGO_LENGTH 

SEGO_?OSITION 

TYPE 


yes 

2 

100 

no 

yes 

2 


no 

100 

2 

"Source /Test id" 
17 
12 

string 
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INCLUDE 


ILE FOR ARCH MASTER. FIL 


C ARCH_REC_DEF . INC 
c 

c This include file describes the archival file records. 


parameter 

volume_key 

- 

0 ’primary key pos . 

parameter 

srctst^Jcey 

■ 

1 ! secondary Jcey pos 

structure /arch/ 



character 

volnam 

*12, 

! Volume name - Key 0 

1 

src_tstid 

*17, 

! Source//Test ID - Key 1 

1 

saveset 

*17, 

!Save set name 

1 

media 

*20, 

! Media type 

1 

date 

*9, 

! Archival date 

1 

text 

*60, 

’Descriptive text 

1 

comment 

*60 

’comment field 

integer*4 

relpos 

! Rei 

ative position on volume 

byte 

filler 


’record filler 

end structure 




record /arch/ 

arch — rec 



character 

source 

*8, 

’ source 

1 

testid 

*8, 

’test ID 

1 

device 

*10, 

’device name 

1 

dbs_dev 

*5, 

’test storage device 

1 

req_volnam 

*12, 

! requested volume 

1 

req^saveset 

*17, 

! requested save set 

1 

reqjdate 

*9 

2 requested date 

integer*2 

ma r ks_pe r_f lie 


’device file markers 

integerM 

num_en tries 


! entries on device 


common /archival/ 
1 
1 
1 
1 
1 
1 
1 
1 
1 


arch_rec, 

source, 

testid, 

device, 

db s_dev, 

req_volnam, 

req_saveset, 

reqjiate, 

marks_j>er_f ile, 

nun entries 
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TEST INDEX FILE 


FILENAME 
TYPE 
PRIMARY KEY 
SECONDARY KEYS 
RECORD LENGTH 

FIELD NAME 


source 

test_ id 

system 

component 

test_engr 

test_cntr 

num_runs 

test^desc 

dbs — device 

test_start 

t e s t_comp_da t e 

arcjm_f lag 

arc_m__vol 

arc_e — flag 

arc_e_vol 

test_right 

test_prot 

num_dbs__labels 
dbs_scale 
dbs exts 


[DBSE] TEST . IND 

Indexed with fixed record length, 
source 

test_id, system, component, test — engr, test^cntr 
196 

TYPE DESCRIPTION 


char*8 

char*8 

char*12 

char*12 

char*16 

char*16 

integer *4 

char*60 

char*5 

char*8 

char*8 

byte 

char*6 

byte 

char*6 

char*10 

char 

integerM 

realM 

charts 


Source of test data. 

Test ID of test data. 

System associated with test data. 

Component associated with test data. 

Engineer associated with test data. 

Contractor associated with test data. 

Number of runs loaded for the test. 
Description of test. 

Test storage device. 

Test start date. 

Test completion date. 

Measured data archival flag. 

Last measured archival volume name. 
Engineering data archival flag. 

Last engineering archival volume name. 

Access restriction identifier. 

Test protection flag. "P" indicates protected 
data . 

Number of labels loaded for test. 

Scale factor. 

List of available type extensions. 
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FDL FILE FOR TEST . IND 

TITLE "File Name : DBDISX: [DBSE] TEST .FDL" 

ID ENT "12-JAN-1990 09:39:27 VAX-11 FDL Editor" 

SYSTEM 

SOURCE "VAX/VMS" 


28 

no 

2 

2 

no 

0 

0 

" [DBSE] TEST . IND" 
indexed 
[ 1 / 1 ] 

(system: RWED, owner :RWED, group :RWE, world :RWE) 


RECORD 

BLOCK_SPAN 
CARRIAGEjCONTROL 
FORMAT 
SIZE 

AREA 0 

ALLOCATION 28 

BUCKET_S I ZE 2 

EXTENSION 0 


yes 

none 

fixed 

196 


ALLOCATION 
BEST_TRY_CONT IGUOUS 
BUCKET_SIZE 
CLUSTER_S I ZE 
CONTIGUOUS 
EXTENS ION 

GLOBAL_BUFFER_COUNT 

NAME 

ORGANIZATION 

OWNER 

PROTECTION 


KEY 0 

CHANGES no 

DATA_AREA 0 

DATA_FILL 100 

DATA_KEY_COMPRESS ION yes 

DATA_RECORD_COMPRESSION yes 
DUPLICATES yes 

IND EX_AREA 0 

INDEX_COMPRESSION yes 

INDEX_FILL 100 

LEVEL1_INDEX_AREA 0 

NAME 

NULLJCEY no 

PROLOG 3 

SEG0_LENGTH 8 

SEGO_?OSITION 0 

TYPE string 
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rDL FILS FOR TEST . IND (Continued) 


KEY 1 


CHANGES 

yes 

DATA AREA 

0 

DATA_FILL 

100 

DATA_KEY_COM?RESS -ON 

yes 

DUPLICATES 

yes 

INDEX_AREA 

0 

INDEX_CCMPRESS ION 

yes 

INDEX_EILL 

100 

LEVEL1_INDSX_AREA 

0 

NAME 

n n 

NULL_KEY 

no 

SEGO LENGTH 

8 

SEGO_POSITION 

8 

TYPE 

string 


KEY 2 

CHANGES 
DATAWARE A 
DATA~FILL 

D ATA_KE Y _COMP RES SION 

DUPLICATES 

IND E X_AREA 

INDEX_COMP RES SION 

INDEX_FILL 

LEVEL 1_IND E X_ARE A 

NAME 

NULL_KEY 
SEGO_LENGTH 
SEGO POSITION 


yes 

0 

100 


yes 

yes 

0 


yes 

100 

0 


no 

12 

16 

string 


KEY 3 


CHANGES 

ves 

DATA_AREA 

o 

DATA_r ILL 

100 

DATA_KEY_COMP HESS ION 

yes 

DUPLICATES 

yes 

IND EX_AREA 

0 

IND EX~COMP RES S ION 

yes 

IND£X_FILL 

100 

LEVEL1_INDEX_AR£A 

0 

NAME 

If If 

NULL_KEY 

no 

SEG0_LSNGTH 

12 

SEG0_?OS ITION 

28 

TYPE 

str. 
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rDL FILE FOR TEST . IND (Concluded) 


KEY 4 


CHANGES 

yes 

DATA_AREA 

0 

DATA_FILL 

100 

D AT A_KE Y_COM? RE S S ION 

yes 

DUPLICATES 

yes 

IND E X_ARE A 

0 

INDEX_COMP RES SION 

yes 

INDEX_FILL 

100 

LEVEL 1_INDEX_AREA 

0 

NAME 

n ft 

NULL_KEY 

no 

SEG0_LENGTH 

16 

SEGO_?OSITION 

40 

TYPE 

string 


KEY 5 

CHANGES yea 

DATA_AREA 0 

DATA_FILL 100 

D AT A_KE Y_COMP RE S S ION yes 
DUPLICATES yea 

INDEX_AREA 0 

INDEX_COMP RES SION yea 

INDEX_FILL 100 

LEVEL1 INDEX_AR£A 0 

NAME 

NULL_KEY no 

SEGO_LENGTH 16 

SEGO_POSITION 56 

TYPE string 
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c 

c 

c 

c 


INCLUDE FILE FOR TEST . IND 

This file defines the TEST* IND data record contents, 
Display sizes for test_rec fields 


8 

8 

12 
12 
16 
1 6 
8 

60 

5 

8 


parameter source_len 

parameter test_id_len 

parameter system_len 

parameter component_len 

parameter test__engr — len 

parameter tea t__cntr_len 

parameter num_runs len 

parameter test desc len 

parameter dJos^device^len 

parameter test start__ len 

parameter test comp_date — len ■* 8 

parameter arc_m — f lag — len 

parameter a r c_ni__vo 1 len 

parameter arc_e__f lag_len 

parameter arc e vol len 

parameter test — right__len 

parameter test_jprot_len 

parameter num_jdbs labels len “ 8 

parameter dbs_scale_len - 8 

parameter dbs__exts^len " 6 

structure /test_ind_record/ 


- 1 
- 6 
- 1 
- 6 

- 10 

- 1 


character 

source 

character 

test_id 

character 

system 

character 

component 

character 

test_engr 

character 

test_cntr 

integerM 

num_runs 

character 

test — desc 

character 

dbs_device 

character 

test_start 

character 

test_comp_date 

byte 

arc_m_f lag 

character 

arc _m_vol 

byte 

arc_e_ f lag 

character 

arc_e — vol 

character 

test_right 

character 

test^prot 

integerM 

num dbs_ labels 

realM 

dbs_scale 

character 

dbs_exts 


source 

test id 

system 

component 

test engineer 

contractor 

number of runs entered 
comment field 
storage device 
starting date 
completion date 

# of meas. data arch, sets 
last meas. arch, set name 

# of eng. data arch, sets 
last eng. arch, set name 
rights protection field 
proprietary protection field 

# of labels loaded 
scale factor 

available file exts. (M/E/ . . ♦) 


* (source^ len) 

* (test_ id_len) 

* (systera_len) 

* (component_len) 

* (test_engr_len) 

* (test_cntr_ len) 

!# runs in the test 

* (test_desc_len) 

* (dbs_device_ len) 

* (test_start_len) 

* (test_comp_date_len) 
Imeasured archival flag 

* ( a r c_m_vo 1_1 e n ) 
leng. archival flag 

* ( a r c_e_vo l_i © n ) 

* ( tester ight_len) 

* (test_prot_len) 

! # labels loaded 
! scale factor 

* (dbs_exts__len) 


end structure 

record / test_ind_record/ test_rec 
record /test_ind_record/ access_rec 

common /test — ind/ test rec , access rec 


USER LCG FILE 

This is the test access log. A record is entered for each user of the 
database system. The record stores the last test accessed by eacn user. 
Each record is 32 bytes long. 


mSNAMS : [DBS2] USBR_LOG.LOG 
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ft ft 


type 
PRIMARY KEY 
RECORD LENGTH 

FIELD NAME 


use r _n ame 
source 
est_id 
ype 


Indexed wi 
username 


32 


h 


fixed record length. 


TYPE DESCRIPTION 


char*15 User accessing database system. 

char*8 Source last accessed by user. 

char*8 Test last accessed by user, 

char * 1 Extension type last accessed by user. 


c - 12 



TITLE 


FDL FILE FOR USER LOG . LOG 


"File Name : DBDISK: [DBSE] USER. LOG" 


IDENT " 9 -AUG-1 9 90 14:21:54 VAX-11 FDL Editor" 


SYSTEM 

SOURCE 


VAX /VMS 


FILE 

ALLOCATION 

BEST_TRY_CONT IGUOUS 

BUCKET_SIZE 

CLUSTER_SIZE 

CONTIGUOUS 

EXTENSION 

GLOBAL_BUFFER_COUNT 

NAME 

ORGANIZATION 

OWNER 

PROTECTION 


10 

yes 

2 

5 

no 

5 

0 


"USER_LOG.LOG 
indexed 
[ 200 , 1 ] 
(system:RWED, 


owne 


RWED, group :RW, world: RW) 


RECORD 

BLOCK_SPAN yes 

CARRIAGE_CONTROL none 

FORMAT fixed 

SIZE 32 


AREA 0 

ALLOCATION 
BUCKET^ SIZE 
EXTENSION 


10 

2 

5 


KEY 0 


CHANGES 

no 

DATA KEY COMPRESSION 

yes 

D AT A_RE C O RD_C OMP RE S S I ON 

yes 

DATA_AR£A 

0 

DATA_FILL 

100 

DUPLICATES 

no 

INDEX_AREA 

0 

INDEXJDOMP RES SION 

yes 

INDEX_FILL 

100 

LEVEL1_INDEX_AR£A 

0 

NAME 

ft *• 

NULL_KEY 

no 

PROLOG 

3 

SEG0 LENGTH 

15 

$EG0“?OSITION 

0 

TYPE 

string 


C - 13 



TEST CHANGE LOG TILE 


This file records modifications made to the VALUE file data cells. 

Nomenclature : "source" is the facility or other data source, 
"test" is the test identifier. 


FILENAME 
TYPE 
PRIMARY KEY 
RECORD LENGTH 


[DBSE . source . test ] test . CHL* 

Indexed with variable record length. 

label//off set 

Maximum of 20544 bytes 


FIELD NAME 


TYPE DESCRIPTION 


mod__ label 
ch_ of f set 
mod_of f set 
ch_field_type 
ch_f ield_len 
mod_original 
num_mods 
mod_ user 
mod^value 
mod_date 
mod time 


char*12 

char*8 

IntegerM 

char 

Integer*2 

byte (12) 

Integer*2 

char*l2 

byte ( 12) 

char*9 

char*8 


Label name of cell modified. 

Offset value of cell modified - character form. 
Offset value of cell modified - integer form. 
Data type of cell modified. 

Number of bytes in data cell. 

Byte array containing original cell value. 
Number of modifications made to data cell. 

User name of process that modified data cell. 
Array of modification values. 

Date that cell was modified. 

Time that cell was modified. 
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FDL FILE FOR TEST CHANGE LOG 


TITLE "File Name : DBDISK : [DBSE] CHANGE_LOG . FDL" 
IDENT "2I-SEP-1990 11:04:56 VAX-11 FDL Editor" 
SYSTEM 

SOURCE "VAX/VMS" 


FILE 

ORGANIZATION 


indexed 


RECORD 

CARRIAGE_CONTROL 

FORMAT 

SIZE 


none 

variable 

20544 


AREA 0 

ALLOCATION 51 

BEST_TRY_CONTIGUOUS yes 

BUCKET S I Z E 4 8 

EXTENSION 48 


AREA 1 

ALLOCATION 48 

BEST_TRY_CONT IGUOUS yes 

BUCKET_SIZE 48 

EXTENSION 48 


KEY 0 


CHANGES no 

DATA_AREA 0 

DATA_FILL 100 

DATA KEY COMPRESSION no 


DATA RECORD COMPRESSION no 


DUPLICATES 

INDEX_AREA 

INDEX_COMPRESS ION 

INDEX_FILL 

LEVEL1_INDEX_AREA 

NAME 

PROLOG 

SEG0_LENGTH 

SEGO_POSITION 

TYPE 


no 

1 

no 

100 

1 

"Label/Offset" 

3 

20 

0 

string 


C - 15 


H < 


INCLUDE FILE FOR TEST CHANGE LOG 


CH_LOG_RSC_DEF . INC 

is file defines the records in the change log files, 
change log file is created for a test whenever a data cell in the 
c value file is modified. 


parameter 

max_mods 

- 1000 

‘maximum mods/cell 

character 

1 

1 

1 

1 

1 

raod__ label 
ch_of f set 
ch_f i e 1 d_t ype , 
mod_user (max_ 
mod_ date (max_ 
mod__time (max_ 

*12, 

*8, 

mods) *12, 

mods) *9, 

mods) *8 

! label of cell 
Icell offset (char) 
‘cell data type 
!user of modification 
!date cell modified 
‘time cell modified 

integerM 

mod_of f set 


Icell offset 

integer*2 

1 

numjrioda , 
ch_f ield_len 


Inumber of cell mods. 
Icell byte size 

byte 

1 

mod_original 
raod_va lue 

(12) , 

(12, max_mods) 

! original value 
I array of mod. values 

common /ch — log/ 
1 
1 

mod__ label/ ch_of fset, mod_off 
num_mods, ch_f ield_type/ ch_f 
mod user, mod_jvalue/ mod_date 

set/ mod_original/ 
ield_len, 
f mod w 
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LA3E 


.E RECORD PARAMETER FILE 


FILENAME 

TYPE 

RECORD LENGTH 


[DBSE . source . test] test . PRM* 
Sequential with fixed record length, 
62 bytes 


FIELD NAME 


TYPE DESCRIPTION 


name 

position 

length 

deform 

description 


char*12 

Integer*2 

Integer*2 

char 

char*40 


The name for the current field in . IND 
The byte position of the field in • IND 
The field length of the field - number of bytes. 
The data type of the field ( R* I, C ) . 

3rief description of the field. 
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INCLUDE FILE FOR LABEL FILE RECORD PARAMETER FILE 


parameter raax_fields - 500 

parameter max_record » 2000 

parameter lablen - 12 


character 

1 

1 

1 

1 


file_nro *4 4, 

)cey_name *12, 

field_name (max_fields) *12, 
field_forra (max_f ields) , 
key_f orm 


label rec 


(max record) 


!max fields per label 
!max label rec. size 
! length of label name 

! . IND file name 
{key field name 
{parameter field names 
{parameter data types 
{key data type 

{label file record 


integer*2 

1 

1 

1 


record_len, 
key_size, 
num_f ields, 
f ield_pos 

field size 


(max_f ields) , 
(max fields) 


label file rec. len. 
size of key field. 

# of parameter fields 
parameter field 
positions . 
parameter field 
lengths - bytes . 


common /parameters/ file_nm, key__name, field_j 
1 key_size, num_f ields, fie 
1 field form, label rec 


name, record^ len, 

Id oos, field size, 
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SET 


FILENAME 
TYPE 
PRIMARY KEY 
RECORD LENGTH 


[DBSE . source .test]cesc. SET* 

Indexed with variable record length. 

set_name 

Variable 


FIELD NAME 


TYPE 


DESCRIPTION 


set_name 

set_ext_num 

set_ext 

num_units 

s e t _v a r_n ame 

label_name 

label val 


char*12 

byte 

byte 

integer*2 

char*12 

char*12 

real *4 


Unique set name. 

Extended record number. 

Extended record flag. 

Number of label 3 for this set. 

Array of X,Y , Z parameter names. 

Array of labels to be included in set. 
Array of X, Y , Z parameter values. 


Pairs of label_name/label_val are repeated for "num_units" labels. 
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FDL FILE FOR SET FILE 


TITLE "File Name : DBDISK : [DBSS] SET . FDL" 


IDENT "21-SEP-1990 12:24:56 VAX-11 FDL Editor" 
SYSTEM 

SOURCE VAX/VMS 


FILS 

ALLOCATION 60 

BEST^TRY — CONTIGUOUS no 

BUCKS T_5 I ZE 2 8 

CLUSTER_SIZE 5 

CONTIGUOUS no 

EXTENSION 0 

FILEJMONITORING no 

GLOBAL_BUFFER_COUNT 0 

NAME 

ORGANIZATION indexed 

OWNER [] 

P ROTECT I ON { 3 y s t em 


RWED, owner : RWED, group :RWED, world:RWED) 


RECORD 

BLOCK_S?AN 

CARRIAGEJ30NTR0L 

FORMAT 

SIZE 


yes 

none 

variable 

24000 


AREA 0 

ALLOCATION 58 
BUCKET_SIZE 28 
EXTENSION 0 


KEY 0 


CHANGES 

no 

DATAJKEYjCOMPRESS ION 

yes 

D AT A_R£ CORD COMPRESSION 

yes 

DATA_AR£A 

0 

DATA_FILL 

100 

DUPLICATES 

no 

INDEX_AREA 

0 

INDEX COMPRESSION 

yes 

INDEXES ILL 

100 

LEVEL1_INDEX AREA 

0 

NAME 

n ft 

NULL_KEY 

no 

PROLOG 

3 

SEG0_LENGTH 

12 

SEG0_?OSITION 

0 

TYPE 

st r; 
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INCLUDE FILE FOR SET FILE 


c 

c File name : INCLUDES : set_rec_de£ . inc 
c 

parameter max_3et_label3 - 2000 

c 

c There are 2 4 bytes per label: 
c 

c label_name : 12 bytes 
c value_array : 3-4 byre REALs 
c 

parameter max_set_store « 1327 

parameter set_header size - 52 


! max sets per rec . 

!set record header size 


character 

1 

1 

1 


set_name *12, !name of set 

labei_name (max_se relabels) *12, !name of label 
set_var_narae (3) *12, !X,Y, Z parameter 

! fields 

ho ld_set_va rename (3) *12 !tentp buffer 


byte set_ext, 

1 set ext nura 


! extended record flag 
! extended record nura. 


integer*2 

1 

integer*4 

real*4 


num _ un -ts / ! nura labels in set 

hold nura_units Iterap buffer 

5et _ rec _l en !set record length 

label_val ( 3 , max_set_labels) !X, Z parameter 

lvalues . 


common / set_par/ set_name, num_units, set_var_name, label name, 
1 label val 
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VALUE FILE 


FILENAME : [DBSE . source . test ] tea t . VLU* 

TYPE : Indexed with variable record length. 
PRIMARY KEY : ctbse_key//ext_number 
RECORD LENGTH : Variable 


FIELD NAME 

TYPE 

DESCRIPTION 


dbse key 

C12 

Label of data record. 


ext number 

B 

Extended record number. 


extension 

3 

Extended record flag. 


case label 

C12 

Version of label to be displayed. 


r e c_f i e 1 d_f o rm 

Cl 

Data type of data cells for this record. 

rec_ f ield_size 

12 

Number of bytes per data cell for this 

record 

cells_loaded 

14 

Number of data cells in this record. 


min_buf 

B 

12-byte array containing minimum value 

loaded 

max_buf 

B 

12-byte array containing maximum value 

loaded 

dbs_rec_len 

14 

Number of bytes in cell data array. 


dbse_rec 

B 

Array of bytes containing cell data. 
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FDL FILE FQR VALUE FILE 


TITLE "File Name : D3DISK : [DBSE] VLU . FDL" 

ID ENT "18-JUN-1990 10:26:38 VAX-11 FDL Editor" 
SYSTEM 

SOURCE "VAX/VMS" 

FILE 

ORGANIZATION indexed 

RECORD 

CARRIAGE^ CONTROL none 

FORMAT variable 

SIZE 31912 

AREA 0 

ALLOCATION 
BESTJTRY_CONTIGUOUS 
BUCKET_SIZE 
EXTENSION 


AREA 1 

ALLOCATION 63 

BE$T_TRY_CONTIGUOUS yea 

BUCKST_SIZE 63 

.EXTENSION 63 


5000 

yea 

63 

1000 


CHANGES 

no 

DATA_AREA 

0 

DATA_FILL 

100 

DATA_XEY_COMPRESSION 

no 

DATA RECORD COMPRESSION 

no 

DUPLICATES 

no 

INDEX_AR£A 

1 

IND EX_COM? RE S S ION 

no 

INDEX_FILL 

100 

LEVEL! INDEX AREA 

1 

PROLOG 

3 

SEG0 LENGTH 

13 

SEG0_POSITION 

0 

TYPE 

atring 
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INCLUDE FILE FOR VALUE FILE 
c 

c File name : INCLUDES : dbse_rec_def . inc 


parameter 

max_ frames * 9800 

(MUST HAVE SAME 


! VALUE AS 3 l_num — rref 3 
( frames allowed 


parameter 

1 

max_dbse_record - 
max__f ramea * 13 

(maximum record length 

parameter 

max_ 3 tore_size - 31850 

!max bytes per rec. 

parameter 

header_size - 61 

! the dbse header size 

parameter 

max__labels - 2000 


parameter 

max_sets “ 1000 


character 

rec_f ield_f orm, 

(data storage format 

1 

dbse_key *12, 

(data access key 

1 

case^ label *12, 


1 

c_min *12, 

(char min 

1 

c_max *12 

(char max 

byte 

dbse_rec (max_dbse_record) , 

(database record 

1 

extension. 


1 

ext__n umber. 


1 

min_buf (12) , 

(min value buffer 

.1 

max_buf (12) 

(max value buffer 

integer*2 

rec_f ield_size, 

(size of field 

1 

i2_min. 

(2 byte int min 

1 

i2__max 

(2 byte int max 

integerM 

db 3 e_r e c_le n , 


1 

cells_loaded. 


1 

i4_min. 

I 4 byte int min 

1 

i4_max 

1 4 byte int max 

realM 

r 4_rain , 

! 4 byte real min 

1 

r4_max 

! 4 byte real max 

real*8 

r8_roin. 

(8 byte real min 

1 

rBjnax 

(8 byte real max 

logical*! 

db 3 e_da t a__a c qu i r ed 



equivalence ( cjrnin, 
equivalence ( i2_min, 
equivalence { i4_min, 
equivalence { r4_min, 
equivalence { r8_min, 
equivalence ( cjnax, 
equivalence ( i2_ max, 
equivalence ( i4_max, 
equivalence ( r4_max, 
equivalence ( r8_ max. 


min_buf ) 
min — buf ) 
min^buf ) 
min_buf ) 
min_buf ) 
max_buf ) 
max_buf ) 
max_buf ) 
maxjbuf ) 
max buf ) 


common /dbse_oar/ cibse^Jcey, case_label, 

1 dbse^frec_len, rec_f ieid_ size, rec_f ield_form, 

1 extension, ext_number, cells_loaded, min_ buf, max_buf, 

1 dbse rec, dbse_data_acquired 
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MAXIMUM RELATIVE POSITION (MRP) FILE 


FILENAME 

TYPE 

RECORD LENGTH 
FIELD NAME 


MRP 


(DBSE . source . test ] test .MRP * 
Sequential - single record. 
4 bytes 

TYPE DESCRIPTION 


14 Maximum relative position. 

Defines the current number of values in the 
VALUE file (test id.VLU*) . 
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TEST REPORTS 


The teat reports are named in the report file name extension. For example, 
if a pre-test report was generated for TEST 0016 in the AF D facility ^ would 
be named 0016 .TPRS-TEST . The report name follows ".T" in the report fr~e 
extension. The reports can only contain ASCII text and the records must not 
exceed 80 characters each. 


FILENAME : 
TYPE : 
RECORD LENGTH : 


[DBSE . source . test ] test . T<report_name>* 
Sequential with variable record lengxh. 
Variable 
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FILENAME 
TYPE 
PRIMARY KEY 
RECORD LENGTH 


[DBS E .source .test] test . IND* 

Indexed with fixed record length. 
engr_label 

Defined in the corresponding .?RM* parameter file. 


FIELD NAME 

TYPE 

engr_label 

C12 

case label 

C12 

datatype 

Cl 

fldlen 

12 

data_segment 



DESCRIPTION 


Uppercase label name used as key. 

Version of label name to be displayed. 
Data storage format (R,C,I). 

Number of bytes required for data field. 
Used to tag data retrieval path. 


These are the required fields. Other data 
record as specified in the corresponding . PRM* 


and fields 
parameter 


are added 
file. 


to the 


TEST GEOMETRY FILE 

FILENAME : (DBSE . source . tea t ] tea t . GEO 

TYPE : Indexed with fixed record length. 
KEY : LCS 

RECORD LENGTH : 102 Bytes 


FIELD NAME 

TYPE 

DESCRIPTION 

ics 

R4 

Local coordinate system number. 

res 

R4 

Reference coordinate system number. 

scale 

R4 

Local scale - lesdimension/resdimension . 

type (3) 

Cl 

Type of local system : 

typed) - L for left-hand Cartesian. 

* X, Y, z for cylindrical axis 
- other defaults to right-hand Cartesian, 
type (2) and type (3) are for cylindrical systems, 
type (2) - X, Y, or Z indicates the axis of origin 
for the cylindrical angle, 
type (3) - R for right-hand cylindrical angle. 

L for left-hand cylindrical angle. 

origin (3) 

R4 

If res is Cartesian/ these are DX, DY DZ. 

If res is cylindrical, these are axial distance/ 
angle, and radius. 

rorder (3) 

Cl 

Order of axis rotations used to align the res 
to the Ics. YZX would indicate rotations about 
Y/ then Z, and finally X. 

rot (3) 

Cl 

Rotation angles in the order specified by rorder. 
Signs of rotations are based on the right-hand 
sense . 

geocom 

C60 

Descriptive comment for the les 
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SESSION LOG FILE 


p t t rNAME t <ujei _ soectf • XSL 

TYPE : Sequential with variable record length. 

RECORD LENGTH : variable - maximum 30 bytes. 

For a complete description of the session log file see -APPENDIX D- 
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RS/1 VALUE TABLE META FILE 


FILENAME : <user-specif ied> . AS 11 

TYPE 2 Seguentisl with vandbiQ record length • 
RECORD LENGTH : Variable 


field name 

TYPE 

DESCRIPTION 



record 1: 
rows 

C6 

Number of rows 
records in the 

represented by 
file (• number 

the number of 
of label names) 


RECORD 2: 

columns C6 


Number of columns represented by the fields 
in the records (- number of data values plus 
1 for the label) . 


Records 3 and 4 are output only if sets were chosen. . 

The purpose of records 3 and 4 is to provide a desired table spacing. 
The record numbering in descriptions of files .RS12 and .RS13 assume that 
these two records are used. 


RECORD 3: 
label 


data 

data 


Ci2 The entry "SET" provides a column in the 

resulting table for set names • 

Ci A tilde is used as a data field separator. 

Ci2 Data value. Should look "EMPTY" to RS/1. 

Ci Data field separator. 

C12 Data - "EMPTY". 

Repeat empty data to length of other 
data records (record 5 and subsequent) . 
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RECORD 4: 
label 


RS/1 VALUE TABLE META FILE (Concluded) 


C12 The entry "PARAMETER" provides a column in 

the table for set plotting parameter names. 



Cl 

Data field separator. 

data 

C12 

Data value. Should look "EMPTY" to RS/1 

»» m 

Cl 

Data field separator. 

data 

C12 

Data value - "EMPTY". 

• 

• 

Repeat empty data to length of other 

. 

• 

data records (record 5 and subsequent) . 

RECORD 5: 

label 

C12 

Name of first label selected. 


Cl 

Data field separator. 

data 

C12 

Data value. 


Cl 

Data field separator. 

data 

C12 

Data value. 

* 


Repeat data values to the length 

* 

• 

of the selected data. 


RECORD 6 and subsequent records : Repeat record 5 for all selected labels. 
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RS / 1 SET TABLE META FILE 


FILENAME : <user-specif ied> . RS 12 

TYPE : Sequential with variable record length. 
RECORD LENGTH : Variable 


FIELD NAME TYPE DESCRIPTION 


C6 Number of rows represented by the number of 

records in the file {• number of set names) . 


C6 Number of columns represented by the number 

of fields in the records (- number of label 
names in table .RS11 plus 2 for the ’•SET" and 
"PARAMETER" columns) . 


RECORD 1: 
rows 


RECORD 2: 
columns 


RECORD 3 and subsequent records. 


label 

C12 

Set name . 


Cl 

Data field separator. 

parameter 

C12 

Set plotting parameter name/ e.g. THETA. 


Cl 

Data field separator. 

data 

C12 

Plotting parameter data value corresponding 
to the label in record 3 of file .RS11, 
or an "EMPTY" indication if the label was 
not entered as part of a set. 


Cl 

Data field separator. 

data 

C12 

Plotting parameter data value corresponding 
to the label in record 3 of file .RS11, 
or an "EMPTY" indication if the label was 
not entered as part of a set. 

W_!* 

Cl 

Data field separator. 


Repeat data values to equal the number of 
labels entered in table .RS11. 
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FILENAME 

TYPE 

RECORD LENGTH 
FIELD NAME 


RECORD 1: 
rows 


RECORD 2: 
columns 


RECORD 3: 
fieldl 

fields 


RS/1 LABEL TABLE META FILE 
<us er- spec if ied> . RS 13 

Sequential with variable record length. 
Variable 

TYPE DESCRIPTION 


C6 Number of rows represented by the number of 

records in the file (« number of label names 
plus 1 for the header line from record 3) . 

Cg Number of columns represented by the number 

of fields in the records (- number of fields 
in the TEST_ID.IND file). 

C12 First field name in the TEST_ID.PRM file. 

Cl Data field separator. 

C12 Third field name in the TEST_ID.PRM file. 

• • 

Repeat order of fields described in the 
TEST_ ID.PRM file to serve as headers for 
the data to be provided in subsequent records. 
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RS/1 LA3EL. TA3LE META FILE (Concluded) 


FIELD 

NAME 

TYPE 

DESCRIPTION 

RECORD 

data 

4: 

C12 

The value of the label name from record 5 
of the .RS11 file. 



Cl 

Data field separator. 

data 


c? 

The value of the second field in the 
TEST_ID.IND file for the label in the field. 

NOTE : 

The 

field length 

w ?" indicates that the field length will vary 


for 

each test and 

field. 

n 


Cl 

Data field separator. 

data 


C? 

The value of the third field in the 




TEST_ID.IND file for the label in the field. 



Cl 

Data field separator. 

data 


c? 

The value of the third field in the 




TEST_ID.IND file for the label in the field. 




Repeat field values to the end of the 

• 


• 

TEST_ID.IND record. 

Record 

5 and subsequent 

records : repeat record 4 for the labels from record 


6 and subsequent in the .RS11 file. 
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